Admin UI

Overview

The user interface consists of five system components:

• Live View - logs information of triggered events when trackables propagate through fences. Event information in the log consists of the fence name through which a trackable is moving, along with entry and exit timestamps.
• Trackables - allows users to assign trackables to the asset being tracked and attach the associated positioning providers. Trackable parameters such as it’s radius, exit delay, and collision tolerance can be defined as per requirements. Additionally, custom properties such as information about the asset can be assigned in this section.
• Location Providers - allows users to create location providers for different positioning technologies (ex. GPS, WiFi, UWB, etc.). Parameters such as the fence timeout, exit delay, and collision tolerance can be defined as per requirements. Additionally, custom properties for the location provider can be assigned in this section.
• Fence Management - allows users to locate numerous fences in one or multiple localization zones. Trackables entering and exiting fences would trigger an event. Different fences could be associated with different localization zones. The system operator and moderator would be responsible for creating and monitoring fences.
• Zone Setup - used to define the localization zones on the map for multiple positioning technologies (ex. WiFi, UWB, RFID, etc.). The individual responsible for installing and implementing the localization infrastructure would set up the zones based on localization techniques. Zones need to be set up once for each site.

Live View

The Live View mostly consists of a web map. At the top right corner, there are overlays/widgets to increase/decrease the zoom level of the map, reset the bearing to North, locate your current device, etc.

Furthermore, the Live View fetches and displays the "event triggers" in a list on the left side of the view. Events are triggered when a trackable and/or a location provider enters and exits a fence. Helpful information, such as the timestamp of the event, are shown.

When a trackable enters a fence, the fence is highlighted in green. Similarly, when a trackable leaves a fence, it is highlighted in red.

Fences

Step 1

To access the Fences menu, click the gear icon at the top right corner of the Admin UI to open the Configuration menu. Click on "Fences".

Step 2

To create a fence, click on “New Fence” from the option in the menu. This will launch a new pop-up window prompting the user to enter properties for the fence, such as the name. Provide a name and any other properties. Click “Next” in the pop-up window.

Step 3

Select points on the map to create a polygon-shaped fence. For example, select 4 points on the map to create a rectangular fence. Additionally, custom properties can be assigned to fences, such as the name of the operation or the name of the material being stored in a fence.

Step 4

A new fence will appear on the map.

Zones

Step 1

To access the Zones menu, click the gear icon at the top right corner of the Admin UI to open the Configuration menu. Click on "Zones".

Step 2

To create a new localization zone, click on “New Zone” and a new pop-up window will be launched to specify characteristics of the zone.

Fill in the name of the zone and the floor level upon which the zone is to be created. Select the desired technology from the dropdown menu.

Step 3

Select a method of creating a zone from the dropdown list and click on "Next". There are 4 methods to create a zone.

Step 3.1

Extent based geometries

Extent based geometries (height/width)

Enter the height and width of the zone rectangle in meters. It is also possible to enter the approximate address where the zone is to be created. Click on "Next" and the zone will appear on the user interface or at the approximate location that was specified.

Adjust the zone orientation by moving and rotating the zone and click on "Save" to update the zone on the user interface.

Local Position Input

Local Position Input (Four-sided Polygon)

Enter the coordinates for each corner of a rectangular zone in meters. It is also possible to enter the approximate address where the zone is to be created. Click on "Next" and the zone will appear on the user interface or at the approximate location that was specified.

Adjust the zone orientation by moving and rotating the zone and click on "Save" to update the zone on the user interface.

GPS Position Input

GPS Position Input (Four-sided Polygon)

Enter the geographic coordinates for each corner of a rectangular zone in the form of longitude and latitude. Click on "Next" and the zone will appear on the user interface.

Adjust the zone orientation by moving and rotating the zone and click on "Save" to update the zone on the user interface.

Drawing on Map

Drawing on map

Locate the desired site on the map using the search bar. Left click on the map to draw a polygonal zone in any shape. For example: Click 4 points to draw a rectangular zone. To finish drawing, left click on the first point you created. On the right side of the user interface, the local position for each point of the newly introduced zone can be modified. Click on the “Save” button to integrate the new zone into the map.

Step 4

The newly created zone will appear on the map. On the left side pane, the list of created zones will appear.

Trackables

Step 1

To create a new trackable in the Admin UI, click on “New Trackable” and a new window will launch prompting for the trackable information. Please fill in the information as required and click “Save” to create a trackable.

Step 2

Once a trackable has been created, it is possible to add custom properties to it.

Location Providers

Step 1

To create a new location provider in the Admin UI, click on “New Location Provider” and a new window will launch prompting for the location provider information. Please fill in the information as required and click “Save” to create a location provider.

Step 2

Once a location provider has been created, it is possible to add custom properties to it.

Subscription

Within the Admin UI, there is a section called "License Information" that includes relevant details related to the license/subscription of your DeepHub instance. To access this menu, click the gear icon at the top right corner of the UI to open the Configuration menu. Click on "Subscription".

The "License Information" page provides administrative information, such as the license type (Trial, Development, Production), customer email, a link to request a license key if needed, and a text box to enter and apply a license key. If the DeepHub instance has an active trial license, the end date and time of the trial period will be shown here as well.

For more information on DeepHub licenses, refer to the License Mechanism section.

Import and Export of Entities

The Import and Export of Entities section is a convenient way to backup or copy relevant states from your DeepHub instance without using the API. It allows for the export of trackables, location providers, fences, and zones altogether in one JSON file.

Within this section, users can choose which entities to export. During the import process, users can select which entities from a given file to add to the system.

"API" of the DeepHub Admin UI

The DeepHub Admin UI offers several URL parameters to customize the Live View.

Pan & Zoom to a specific location by specifying:

• lng: the longitude to which the map should pan.
• lat: the latitude to which the map should pan.
• zoom: the zoom level. Must be in the range [0,24], where 0 corresponds to a zoomed out view of the globe, and 24 corresponds to a detailed, zoomed in view. For more information, refer to MapTiler - our default mapping service provider: Tiles à la Google Maps_.

/map/system/live?lng=9.5367&lat=49.4055&zoom=9

OR:

• id: pan & zoom to the last known location of a trackable or location provider with the given id(s). If several ids are provided, they must be comma-separated.
• filterid: only render trackables and location providers with the given id(s). If several ids are provided, they must be comma-separated.

/map/system/live?id=d49f0712-dcbd-4cbc-8b4f-c006b8555839